.. _cmlPmCfgGetInMode:

cmlPmCfgGetInMode
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmlPmCfgGetInMode([in] VT_I4 BoardID,  [in] VT_I4 NodeId, [in] VT_I4 Channel, 
    [out] VT_PI4 InputMode, [out] VT_PI4 IsReverse )                          
    
DESCRIPTION
`````````````  

- cmlPmCfgSetInMode()/cmlPmCfgGetInMode() 함수는 Feedback Pulse의 입력 모드를 설정 혹은 반환합니다. 

\

- Feedback 펄스는 실제 모터 또는 구조물의 구동 거리를 확인하기 위하여 사용되며 거의 대부분 인코더 
  입력을 사용합니다. 사용자는 4가지 형태의 Feedback 펄스의 입력 모드를 설정할 수 있습니다.

\

- 또한 이 함수는 입력 펄스의 로직( Feedback Count값의 UP/DOWN 방향)을 설정합니다.  

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의
  첨두어 cml 가 붙지 않습니다.


PARAMETER
`````````````

▶ BoardID : 사용자가 설정한 디바이스(보드) ID. 
 
▶ NodeId : 노드 번호. 노드 번호는 3부터 시작합니다. 
 
▶ Channel : 축 번호. 통합 축으로 관리되는 축 번호를 의미하며, 상수 값으로 0 (Zero Based) 이상, 최대 
통합 축 개수 - 1 이하의 값을 축 번호로 설정할 수 있습니다. 
 
▶ InputMode : Feedback펄스 입력 모드를 설정 혹은 반환합니다. 설정 가능한 입력 모드는 다음과 
같습니다. 

.. csv-table::
    :widths: 10 90
    :header-rows: 1
    :stub-columns: 0

    Value, Meaning
    0 (ccmlIMODE_AB1X), 1X A/B (1채배 엔코더 입력 모드) 
    1 (ccmlIMODE_AB2X), 2X A/B (2채배 엔코더 입력 모드) 
    2 (ccmlIMODE_AB4X), 4X A/B (4채배 엔코더 입력 모드) 
    3 (ccmlIMODE_CWCCW), CW/CCW (A펄스 - 카운트 증가, B펄스 - 카운트 감소) 
    "| 4 (ccmlIMODE_STEP) ", "
     |                       이 모드에서는 Feedback 위치 값을 읽으면 Command 위치값이 바이패스(bypass) 됩니다.  
     |                       엔코더 피드백이 없는 경우(스텝모터)에 이 모드를 선택합니다. " 

▶ IsReverse : Feedback Count 값의 UP/DOWN 방향을 반대로 할 것인지 설정 혹은 반환합니다. 

.. csv-table::
    :widths: 10 90
    :header-rows: 1
    :stub-columns: 0

    Value, Meaning
    0 (cmlFALSE), Feedback count 의 UP/DOWN 방향이 반대가 아닙니다. 
    1 (cmlTRUE), Feedback count 의 UP/DOWN 방향이 반대입니다. 
    
RETURN VALUE
`````````````
.. csv-table::
    :widths: 10 90
    :header-rows: 1
    :stub-columns: 0

    Value, Meaning
    음수, 수행 실패
    0(ERR_NONE), 수행 성공



EXAMPLE
```````````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

    C/C++ 
    #include “ComiMLink2_SDK.h” 
    #include “ComiMLink2_SDK_Def.h” 
    long nChannel = 0;//0번 축을 선택합니다. 
    Long BoradID = 0; 
    long nInputMode = 0; 
    long nIsReverse = 0; 
    /*0 번 축의 Input Mode를 CW/CCW로 설정하고,  
    Feedback Count 값의 UP/DOWN 방향을 반대로(Reverse Mode를 cmlFALSE로) 설정합니다.*/ 
    cmlPmCfgSetInMode (BoardID, 0, nChannel, ccmlIMODE_CWCCW, cmlFALSE ); 
    /*0 번 축의 Input Mode를 nInputMode변수를 통해서 반환 받고,  
    Reverse Mode 의 설정 여부를 nIsReverse를 통해서 확인합니다.*/ 
    cmlPmCfgGetInMode (BoardID, 0 , nChannel, &nInputMode, &nIsReverse );